RangeFrom Method

Wintellect PowerCollections

previous page next page

[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]

Returns a View collection that can be used for enumerating a range of the items in the bag. Only items that are greater than (and optionally, equal to) from are included. The items are enumerated in sorted order. Items equal to from can be included or excluded depending on the fromInclusive parameter.

Namespace: Wintellect.PowerCollections
Assembly: PowerCollections (in PowerCollections.dll)

Syntax

C#
public OrderedBag<T>.OrderedBag<(Of <T>)>..::View RangeFrom( T from, bool fromInclusive )

Visual Basic (Declaration)
Public Function RangeFrom ( _ from As T, _ fromInclusive As Boolean _ ) As OrderedBag<(Of <T>)>..::View

Visual C++
public: OrderedBag<(Of <T>)>..::View^ RangeFrom ( T from, bool fromInclusive )

Parameters

from: T
The lower bound of the range.

fromInclusive: Boolean
If true, the lower bound is inclusive--items equal to the lower bound will be included in the range. If false, the lower bound is exclusive--items equal to the lower bound will not be included in the range.

Return Value

An OrderedBag.View of items in the given range.

Remarks

Typically, this method is used in conjunction with a foreach statement. For example:

	Copy Code
foreach(T item in bag.RangeFrom(from, true)) { // process item }

If an item is added to or deleted from the bag while the View is being enumerated, then the enumeration will end with an InvalidOperationException.

Calling RangeFrom does not copy the data in the tree, and the operation takes constant time.